/**
 * A simple class that provides the basic implementation needed to make any element a drop target
 * that can have draggable items dropped onto it.  The drop has no effect until an implementation
 * of notifyDrop is provided.
 */
Ext.define('Ext.dd.DropTarget', {
    extend: 'Ext.dd.DDTarget',
    requires: ['Ext.dd.ScrollManager'],

    /**
     * Creates new DropTarget.
     * @param {String/HTMLElement/Ext.dom.Element} el The container element or ID of it.
     * @param {Object} config
     */
    constructor: function(el, config) {
        this.el = Ext.get(el);

        Ext.apply(this, config);

        if (this.containerScroll) {
            Ext.dd.ScrollManager.register(this.el);
        }

        this.callParent([this.el.dom, this.ddGroup || this.group,
                         { isTarget: true }]);
    },

    /**
     * @cfg {Boolean} containerScroll
     * True to register this container with the ScrollManager for auto scrolling during
     * drag operations.
     */
    containerScroll: false,

    /**
     * @cfg {String} ddGroup
     * A named drag drop group to which this object belongs.  If a group is specified, then
     * this object will only interact with other drag drop objects in the same group.
     */
    /**
     * @cfg {String} [overClass=""]
     * The CSS class applied to the drop target element while the drag source is over it.
     */
    /**
     * @cfg {String} dropAllowed
     * The CSS class returned to the drag source when drop is allowed.
     */
    dropAllowed: Ext.baseCSSPrefix + 'dd-drop-ok',
    /**
     * @cfg {String} dropNotAllowed
     * The CSS class returned to the drag source when drop is not allowed.
     */
    dropNotAllowed: Ext.baseCSSPrefix + 'dd-drop-nodrop',

    /**
     * @private
     */
    isTarget: true,

    /**
     * @private
     */
    isNotifyTarget: true,

    /**
     * The function a {@link Ext.dd.DragSource} calls once to notify this drop target that the
     * source is now over the target.  This default implementation adds the CSS class specified
     * by overClass (if any) to the drop element and returns the dropAllowed config value.
     * This method should be overridden if drop validation is required.
     * @param {Ext.dd.DragSource} source The drag source that was dragged over this drop target
     * @param {Event} e The event
     * @param {Object} data An object containing arbitrary data supplied by the drag source
     * @return {String} status The CSS class that communicates the drop status back to the source
     * so that the underlying {@link Ext.dd.StatusProxy} can be updated
     * @template
     */
    notifyEnter: function(source, e, data) {
        if (this.overClass) {
            this.el.addCls(this.overClass);
        }

        return this.dropAllowed;
    },

    /**
     * The function a {@link Ext.dd.DragSource} calls continuously while it is being dragged over
     * the target. This method will be called on every mouse movement while the drag source is over
     * the drop target. This default implementation simply returns the dropAllowed config value.
     * @param {Ext.dd.DragSource} source The drag source that was dragged over this drop target
     * @param {Event} e The event
     * @param {Object} data An object containing arbitrary data supplied by the drag source
     * @return {String} status The CSS class that communicates the drop status back to the source
     * so that the underlying {@link Ext.dd.StatusProxy} can be updated
     * @template
     */
    notifyOver: function(source, e, data) {
        return this.dropAllowed;
    },

    /**
     * The function a {@link Ext.dd.DragSource} calls once to notify this drop target
     * that the source has been dragged out of the target without dropping.
     * This default implementation simply removes the CSS class specified by `overClass`
     * (if any) from the drop element.
     * @param {Ext.dd.DragSource} source The drag source that was dragged over this drop target
     * @param {Event} e The event
     * @param {Object} data An object containing arbitrary data supplied by the drag source
     * @template
     */
    notifyOut: function(source, e, data) {
        if (this.overClass) {
            this.el.removeCls(this.overClass);
        }
    },

    /**
     * The function a {@link Ext.dd.DragSource} calls once to notify this drop target that
     * the dragged item has been dropped on it. This method removes any `overClass` and returns
     * false, so you must provide an implementation that does something to process the drop event
     * and returns true so that the drag source's repair action does not run.
     *
     * You should `callParent` from an override of this method to ensure proper cleanup is
     * performed.
     *
     * @param {Ext.dd.DragSource} source The drag source that was dragged over this drop target
     * @param {Event} e The event
     * @param {Object} data An object containing arbitrary data supplied by the drag source
     * @return {Boolean} False if the drop was invalid.
     * @template
     */
    notifyDrop: function(source, e, data) {
        if (this.overClass) {
            this.el.removeCls(this.overClass);
        }

        return false;
    },

    destroy: function() {
        if (this.containerScroll) {
            Ext.dd.ScrollManager.unregister(this.el);
        }

        this.callParent();
    }
});
